Review of PR #16408: Updated Insights Page

Thank you for this comprehensive update to the Insights page. I've reviewed the changes and found several issues that need attention:

Critical Issues

1. Missing newline at end of file

File: layouts/partials/customer-logos/spearAI.html
Line: 1

The file does not end with a newline. Per AGENTS.md, all files must end with a newline.

<img class="h-full" src="/logos/customers/spearAI.svg" alt="Spear AI" />

Style Issues

2. H2 heading capitalization

File: content/product/insights-governance.md
Line: 100

"The Complete Governance Lifecycle" uses Title Case for an H2 heading. Per STYLE-GUIDE.md, H2 and deeper headings should use Sentence case.

governance:
    title: The complete governance lifecycle

3. H2 heading capitalization

File: content/product/insights-governance.md
Line: 96

"Pre-Built Compliance Frameworks Ready to Deploy" uses Title Case. Should be Sentence case.

compliance_frameworks:
    title: Pre-built compliance frameworks ready to deploy

4. H2 heading capitalization

File: content/product/insights-governance.md
Line: 117

"Analytics & Intelligence" uses Title Case. Should be Sentence case.

analytics:
    title: Analytics & intelligence

5. H2 heading capitalization

File: content/product/insights-governance.md
Line: 124

"Pricing" could benefit from a more descriptive title, but if keeping it as-is, consider making it lowercase unless it's meant as a proper heading.

6. H2 heading capitalization

File: content/product/insights-governance.md
Line: 131

"Take control of your cloud" - While this is Sentence case, the nested items have titles that may need review:

• Line 133: "Start with complete visibility" (good - Sentence case)
• Line 142: "Transform Governance from Bottleneck to Competitive Advantage" - This uses Title Case and should be Sentence case.

        - title: Transform governance from bottleneck to competitive advantage

7. Lowercase "stack" usage

File: content/product/insights-governance.md
Line: 28

Per STYLE-GUIDE.md, use lowercase for non-proper nouns like "stack". Review the content to ensure consistent lowercase usage of common infrastructure terms.

Content Issues

8. Awkward phrasing

File: content/product/insights-governance.md
Line: 25-26

"Complete visibility and control for your cloud" is repeated twice - once in line 6 (subheading) and again in line 25 (overview header). Consider varying the language.

9. Missing article

File: content/product/insights-governance.md
Line: 127

"Insights & Governance capabilities are included with Pulumi Cloud" - Consider adding "the" before "Pulumi Cloud" for better readability, or check if the existing phrasing matches brand guidelines.

10. Inconsistent terminology

File: content/product/insights-governance.md
Lines: 37, 72, 93

The document uses both "Policy as Code" (line 37) and "policy-as-code" (line 31) and "Policy-as-code" (line 72). Choose one consistent style and apply throughout. Per typical conventions, when used as a compound modifier, hyphenate it: "policy-as-code". When used as a title/proper reference, "Policy as Code" is appropriate.

11. Redundant phrasing

File: content/product/insights-governance.md
Line: 129-130

"Pulumi Neo's policy remediation capabilities and pre-built compliance frameworks." - This sentence fragment appears incomplete. It seems like part of a sentence was removed during editing.

Template/HTML Issues

12. Whitespace-only changes in header.html

File: layouts/partials/header.html

The diff shows extensive whitespace reformatting. While the indentation is now more consistent, this creates a large diff that makes it harder to review the actual content changes. Consider whether this reformatting was intentional or if it was an accidental editor setting change.

13. Link updates look correct

Files: layouts/index.html, layouts/page/why-pulumi.html

The link updates from /product/pulumi-insights/ to /product/insights-governance/ are correct and necessary. Good work maintaining consistency.

Verification Needed

14. Internal link search

Per AGENTS.md, when moving files, you should update internal links in /content/docs/ and /content/product/. Consider running:

grep -r "pulumi-insights" content/docs content/product --include="*.md" --include="*.html"

to ensure all references have been updated.

15. Image files verification

The diff shows several new image files added under static/images/product/. These appear as binary files with no content shown. Please verify:

• Images have reasonable file sizes
• Images are optimized for web
• Alt text is provided where images are referenced in content

Positive Notes

✅ Aliases are properly configured in the frontmatter
✅ The file move preserves SEO with appropriate redirects
✅ Content is comprehensive and well-structured
✅ Customer quote attribution is clear

Action Items

1. Fix the missing newline in spearAI.html
2. Convert H2+ headings to Sentence case throughout
3. Standardize "policy-as-code" terminology
4. Complete the sentence fragment on line 129-130
5. Verify all internal links have been updated
6. Confirm image optimization

Mention @claude if you'd like me to help fix these issues or conduct additional reviews.

Your site preview for commit 1b251f3 is ready! 🎉

http://www-testing-pulumi-docs-origin-pr-16408-1b251f32.s3-website.us-west-2.amazonaws.com.

Your site preview for commit ec553d2 is ready! 🎉

http://www-testing-pulumi-docs-origin-pr-16408-ec553d23.s3-website.us-west-2.amazonaws.com.

@kimberleyamackenzie please increase the white space between sections, it is too compressed.

Top sections

Also on the key features, there is some odd shading, it should be very mild to make it pop. @vctrfrnndz can you assist?

Quick mock-up for reference:

Pre-built Compliance section

Make the button primary, so it pops more

Governance Lifecycle section

Increase the space between title and the bar. Remove shade of the image and increase it (or does the image have empty space that is making it that size?) Quick Mockup below:

2. CTA Consolidation - Reduce from 8 to 3
   Current: 8 different CTAs (Save the Date, Get Started 3x, Book a Demo 2x, Explore Policy Packs, View Pricing, Try Free)

Change to:

Primary CTA: "Book a Demo" (hero + 1-2 strategic placements)
Secondary: "Get Started" (self-service path)
Tertiary: "View Pricing" (buying committee)
Remove/consolidate: Multiple "Get Started" variants, "Save the Date" (post-launch), redundant demo CTAs

@scottmparker Can you clarify exactly where you want the CTAs and which CTAs I should remove? The current CTAs are all directly from your doc.

1. Elevate "Works with Any IaC Tool" - Critical Differentiator Buried
   Current: This key message is buried mid-paragraph in body copy

"...whether managed by Pulumi, Terraform, CloudFormation, or created manually"

Change: Add prominent callout near hero section:

✓ Works with Pulumi, Terraform, CloudFormation, and manually-created resources

@scottmparker As well, please let me know where this should be "near hero" - in the body? A secondary subtitle?

@vctrfrnndz Can you help with updating the screenshot assets as @SaraDPH suggests, and decrease the white space around the diagram asset? Thank you!!

@kimberleyamackenzie I deleted my comment and will withdraw the requests for now. Please disregard, and sorry for the confusion.

@kimberleyamackenzie Updated diagram asset without spacing:

@vctrfrnndz I think the other request is to change the other screenshot assets too, so they use more of a shadow than the gray background?

Most recent updates:

• Incorporated @SaraDPH's feedback above
• Updated diagram image from @vctrfrnndz
• Added the Spear AI Case study
• Added compliance logos

Still need:

• Updated screenshot assets
• Meta image and description for insights page

Your site preview for commit 32dca78 is ready! 🎉

http://www-testing-pulumi-docs-origin-pr-16408-32dca78e.s3-website.us-west-2.amazonaws.com.

Your site preview for commit 7099455 is ready! 🎉

http://www-testing-pulumi-docs-origin-pr-16408-70994555.s3-website.us-west-2.amazonaws.com.

Feedback with @scottmparker copy changes + visuals

1, Swap order of header and subheader

Headline: "Continuous Compliance, By Construction"
Subheader: "See everything. Control everything. Ship with confidence."

2. Key features

Align all text to the left instead of the center in all sections/blocks.

Block 1

Update copy to:
Works with ANY infrastructure—Pulumi, Terraform, CloudFormation, or manual deployments.

Continuous audit scans evaluate your entire infrastructure against industry frameworks without disrupting deployment pipelines. Non-blocking compliance checks provide instant visibility into your security posture across CIS Controls, NIST SP 800-53, HITRUST CSF, and PCI DSS standards.

Block 5

Update the headline and copy

Headline: Give Developers AI-Powered Guardrails, Not Red Tape

Copy:
Developers get immediate policy feedback during deployment, with AI-generated fixes when issues arise. Platform teams get measurable compliance improvements without becoming bottlenecks. Policy enforcement accelerates development velocity.

• Shift-left security with pre-deployment validation
• Clear, actionable error messages
• Policy-aware AI remediation
• Measurable compliance improvements without velocity loss

3. Pre-Built Compliance Frameworks section

Make the NIST logo the same size of the other circular logos.

Is Vic working on providing the images with the faded shade or no shade?

New assets with shading adjustments @kimberleyamackenzie

New assets with shading adjustments @kimberleyamackenzie

These are still very harshly shaded on the edges. The image needs to have 100% transparency on the edges @vctrfrnndz

Or would be easier for you @kimberleyamackenzie to have no shading on the image and you can code it like I see it done in other sections?

Note: The Spear AI case study looks good. Preview link provided to the customer for external review/approval (content claims).

@kimberleyamackenzie @SaraDPH Assets without background, only shadow.

Your site preview for commit 6e03da8 is ready! 🎉

http://www-testing-pulumi-docs-origin-pr-16408-6e03da8b.s3-website.us-west-2.amazonaws.com.

Your site preview for commit e531a6a is ready! 🎉

http://www-testing-pulumi-docs-origin-pr-16408-e531a6aa.s3-website.us-west-2.amazonaws.com.

@kimberleyamackenzie The page looks good! Final touches to update the current preview:

What it currently shows:

Title

Where it shows "Cloud Asset and Compliance Management - Pulumi Insights" to change to "Insights & Governance - Continuous Compliance, By Construction"

Meta description

Automated compliance made simple — continuously audit, remediate, and enforce policies to keep your cloud secure and reliable.

Meta image